Web Wiz Guide - Web Wiz Rich Text Editor release version 3.1


****************************************************************************************
*  Copyright Notice    
**
**  Web Wiz Rich Text Editor
**  http://www.richtexteditor.org
**                                                              
**  Copyright 2001-2006 Web Wiz. All Rights Reserved.   
** 
**  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS UNDER LICENSE FROM 'WEB WIZ'. 
**  
**  IF YOU DO NOT AGREE TO THE LICENSE AGREEMENT THEN 'WEB WIZ' IS UNWILLING TO LICENSE 
**  THE SOFTWARE TO YOU, AND YOU SHOULD DESTROY ALL COPIES YOU HOLD OF 'WEB WIZ' SOFTWARE
**  AND DERIVATIVE WORKS IMMEDIATELY.
**  
**  If you have not received a copy of the license with this work then a copy of the latest
**  license contract can be found at:-
**
**  http://www.webwizguide.com/license
**
**  For more information about this software and for licensing information please contact
**  'Web Wiz' at the address and website below:-
**
**  Web Wiz, Unit 10E, Dawkins Road Industrial Estate, Poole, Dorset, BH15 4JD, England
**  http://www.webwizguide.com
**
**  Removal or modification of this copyright notice will violate the license contract.
**
****************************************************************************************




Introduction
===========================================================================================
Thank you for downloading this application and hopefully you will find it of benefit to you.

If you have not downloaded this application from Web Wiz Guide then check for the latest
version at: -

http://www.richtexteditor.org


This application uses ASP and must be run through a web sever supporting ASP. 

It has been tested with IIS on Windows 2003/2000/XP/NT4

Rich Text Enabled browsers supported include
	
	Internet Explorer 5.5+ (Windows only)
	Mozilla (Sea Monkey) 1.3+ (all platforms)
	Netscape 7.1 (all platforms)


The Web Wiz Rich Text Editor is part of a number of ASP based applications available from
Web Wiz Guide.

The Web Wiz Rich Text Editor can be used to turn any HTML textarea within a form into an
editable Rich Text Editor (thats the theory anyway).

===========================================================================================






FOR HELP ON INTEGRATION PLEASE SEE SUPPORT FORUM AT:-
---------------------------------------------------

http://forum.webwizguide.com






Using Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Unzip all the files keeping the directory structure intact.

2. Files must be run through an ASP enabled web server or on ASP enabled web space. (check with 
your hosting company).

3. Point your web browser at the default.asp page.

===========================================================================================






Integration of Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Due to problems that image, link, etc. paths can course, the RTE files, and sub folders, need 
to be placed in the same folder as contains the web page you wish to include the RTE within.


2. The web page that contains your HTML web form textarea you wish to turn into an RTE textarea must
have an .asp extension (eg. my_own_form_file.asp (this is an example file name and not a real
file)

3. Your HTML textarea needs to be part of a form if you wish to post the user entered data to
the server. The form must also use the POST method to send the form data to the server.


3. The following onLoad event must be placed into the <body> tag of your web page to initialise the 
RTE textarea:-

	onLoad="initialiseWebWizRTE();"

An exmaple would be:-

	<body OnLoad="initialiseWebWizRTE();">


4. The code below must be copy and pasted into your web page immediately above the HTML textarea 
in your web form that is to become the RTE textarea (the HTML textarea can have pre filled content
if you wish):-


	<%

	'Declare the ASP variables used
	Dim strFormName
	Dim strTextAreaName
	
	'ID tag name of the HTML form the textarea is within
	strFormName = ""
	
	'ID tag name of HTML textarea being replaced
	strTextAreaName = ""
	
	%>
	<!-- include the Web Wiz Rich Text Editor -->
	<!--#include file="RTE_editor_inc.asp" -->




5. You are almost done, but before you can use the RTE you need to edit a couple of the
lines above you have just copyied and pasted into your web page to initialise the variables 
with the 'name' and 'id' properties of your HTML web form and your textarea tags. (Please note your
HTML web forms 'form' and 'textaera' tags MUST have 'name' and 'id' properties)

	5.1. Change the 'strFormName' variable shown below to place between the quotes ("") the 
	     name of your web form that your textarea is within (eg. strFormName = "myForm"):-
	
			strFormName = ""
			
	     If your form doesn't have a 'name' AND 'id' property then place name="myForm" id="myForm" 
	     within the form tag
	
	
	5.2. Change the 'strTextAreaName' variable shown below to place between the quotes ("") 
	     the id of your forms textarea that you wish to turn into the RTE textarea (eg. if the 
	     textarea has id="myTextarea" you would use strTextAreaName = "myTextarea"):-
	     
	     		strTextAreaName = ""
		
	     If your textarea doesn't have an 'name' AND 'id' then place name="myTextarea" id="myTextarea" 
	     within the textarea tag
	


6. Thats it, your new RTE textarea is ready to use :-)


Hopefully the instructions above were not to hard to follow. If you have problems checkout 
the free support forum at:-

	http://forum.webwizguide.com

Being the developer, with to much inside knowledge of the application, sometimes it can be hard
to write instructions for beginners to understand, so if you can improve on the above please
drop an email to Web Wiz Guide and let me know. Thanks.

===========================================================================================








Problems running the Web Wiz Rich Text Editor
===========================================================================================

If you are having trouble with the application then please take a look at the FAQ pages at: -

	http://www.webwizforums.com


If you are still having problems then post support questions, queries, suggestions, at: -
	
	http://forum.webwizguide.com

If you require official support for this application then this can be purchased for a fee
from Web Wiz Guide.

===========================================================================================






Customising the Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Edit the file 'RTE/RTE_configuration/RTE_setup.asp' with a text editor to enable and disable 
features of the RTE Editor and also setup items like file and image uploading

2. The file 'RTE/RTE_configuration/skin_file.asp' and 'RTE/RTE_configuration/default_style.css' 
can be edited with a text editor to change the look a feel of the RTE Editor

===========================================================================================







Problems with relative paths when inserting images, files, emoticons etc.
===========================================================================================

If you are submitting the contents of the RTE Editor to a file outside of the folder containing
the submission form and RTE file you may find that relative links to images, files, emoticons 
etc are no longer correct to fix this follow the instructions below:-

1. Open the file 'RTE_configuration\RTE_Setup.asp' in a text editor

2. Change the following line to true:-

	Const blnUseFullURLpath = false
Eg.:-	
	Const blnUseFullURLpath = true
	
	
3. Chnage the following to include the URL path, including your domain to the RTE folder:-

	Const strFullURLpathToRTEfiles = "http://"	
Eg.:-
	Const strFullURLpathToRTEfiles = "http://www.mywebsite.com/RTE/"

===========================================================================================








How the Web Wiz Rich Text Editor works
===========================================================================================

Before trying to integrate the Web Wiz Rich Text Editor (RTE) into your own web sites forms or modify it, its best to explain how the Web Wiz RTE works so you have an understanding of the concept behind it.

The Web Wiz RTE uses the built in Rich Text Editing API features of the browser, in Mozilla based browsers this is through its Gecko API

Reserved words (can not be used as ID names for form elements:-

	action
	submit
	reset
	WebWizRTE
	Pre
	toolbar
	ToolBar1
	ToolBar2
	command
	colourPalette
	formatFont
	fontSelect
	textSize


===========================================================================================





Removing Adverts, Limtations, Labels, and Branding from the Application
===========================================================================================

If you like using this application then please help support the development and update of 
this and future applications.

If you would like to remove the any Adverts, Limtations, Labels, and Branding from this 
applications you can purchase a license to do so from Web Wiz Guide.


Payments can be made securely on-line using your credit or debit card for more information
please see the follwing page:-

	http://www.webwizguide.com/purchase

===========================================================================================







Windows 2003 ASP Web Hosting
===========================================================================================

If you are having problems running this application on your own web space then you can have
this application pre-installed for you when purchasing hosting from us.

For more information on web hosting from Web Wiz Guide please see: -

http://www.webwizhost.com

===========================================================================================





Other ASP Applications
===========================================================================================

The following ASP Appliacations are available from http://www.webwizguide.info 

	Web Wiz Forums (award winning bulletin board system)
	Web Wiz Mailing List (full newsletter management system)
	Web Wiz Rich Text Editor (Free replacement WYSIWYG Editor for text areas)
	Web Wiz CAPTCHA (anti-spam, anti-hacking security images)

===========================================================================================